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Limited Warranty on Media 
and Reptffcement 

If you discover physical defects In the manuals 
distributed with an Apple product or in the media 
on which a software product is distributed, Apple 
will replace the media or manuals at no charge to 
yoUr provided you return the item to be replaced 
with proof of purchase to Apple or an authorized 
Apple dealer during the 90-day period after you 
purchased the software. In addition. Apple will 
replace damaged software media and manuals 
for as long as the software product is included in 
Apple's Media Exchange Program. 

While not an upgrade or update method, this 
program offers additional protection for up lo 
two years or more from the date of your original 
purchase. See your authorized Apple dealer for 
Program coverage and details. In some countries 
the replacemer>t period may be different, check 
with your authorized Apple dealer. 

ALL IMPLIED WARRANTIES ON THE MEDIA 
AND MANUALS, INCLUDING IMPLIED 
WARRANTEES OF MERCHANTABILITY AND 
FJTNESS FOR A PARTICULAR PURPOSE, ARE 
LIMITED JN DURATION TO NINETY (90) DAYS 
FROM THE DATE OF THE ORIGINAL RETAIL 
PURCHASE OF THIS PRODUCT. 



Evan though Apple has tested the software and 
reviewed the documentation APPLE MAKES NO 
WARRANTY OH REPRESENTATION, EtTHEH 
EXPRESS OR IMPLIED, WITH RESPECT TO 
SOFTWARE. ITS QUALITY, PERFORMANCE, 
MERCHANTABILITY, OR FITNESS FOR A 
PARTICULAR PURPOSE. AS A RESULT, THIS 
SOFTWARE IS SOLD "AS IS," AND YOU THE 
PURCHASER ARE ASSUMING THE ENTIRE 
RISK AS TO ITS QUALITY AND 
PERFORMANCE. 

IN NO EVENT WILL APPLE BE LIABLE FOR 
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR 
CONSEQUENTIAL DAMAGES RESULTING 
FROM ANY DEFECT IN THE SOFTWARE OR ITS 
DOCUMENTATION, even il advised of the 
poss4bifi1y of such damages. In particular, Apple 
shall have no liability lor any prograrns or data 
stored in or used with Apple products, induding 
the costs of recovering such programs or data. 

THE WARRANTY AND REMEDIES SET FORTH 
ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL 
OTHERS, ORAL OR WRITTEN, EXPRESS OR 
IMPLIED. No Apple dealer, agent, or employee is 
authorized to rnake any modification, exiension. 
or addition to this warranty. 

Some stales do not allow the exclusion or 
limitation of implied warranties or habilily for 
incidental or consequential damages, so the 
above Mmjtation or exclusion may not apply to 
you. This warranty gives you specific legal rights, 
and you may also have other rights which vary 
from state to slate. 



Warning 

This equipment has been certified to comply with 
the limits for a Class B computing device, 
pursuant lo Subpart J of Part 15 of FCC Rules, 
Only peripherals {computer in put /out put devices, 
terminals, printers, etc.) certified to comply with 
the Class B limits may be attached lo this 
computer. Operation with n on -certified 
peripherals is likely to result In interference to 
radio and TV reception 
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Radio and Television Interference 



The equipmenl descnbed in Ihis manual generales and uses radio- 
frequency energy. If it is not inslalled and used pjopedy, lhal is, jn 
ainci accordance wflh our fnslmctioris. il may cause inlerTerence 
wilh radio and television recepDon. 

Ill IS equipmeni has been lested and comities wlirt The flmits tor a 
CEass B compulrng device In accordance wilh the specifications in 
Subpart J. Part 15, of FCC rules These rules are designed fo 
provide reasonable proleclion agalnsi such mterterence In a 
residential inslailalion Howeuer [here is no gyaraf)lee ItiaT Ihe 
Interlerence will not occur in a particular inslallalion, especially if 
you use a "rabbil ear' [eleviston anienna. fA ' rabbil ear ' antenna is 
the telescoping -rod lype usuaNy contafned on TV receivers) 

Vou can delermlne whelJier your computer is causing interference 
ay turning II off. It Ihe interference slops, it was probably caused 
by Ihe computer or its peripheral devices. To further isotaie the 
problem. 

• Disconnect Itre peripheral devices and their input.oulput cables 
one at a time If Ihe interference stops, it is caused by either 
the peripheral device or Us I'O cable. These devices usually 
require shielded I/O cables For Apple penpheral devices, you 
can obEajn Ihe proper shielded cable from your dealer For non- 
Apple perlphersi devices, coniacl the manufacturer or dealer 
for assistance. 

If your computer does cause fnterlerence lo radio or television 
reception, you can try to correct the interference by using one or 
more of the following measures, 

• Turn the TV or radio antenna until the inlerference sEops 

■ Move Ihe computer lo one ^de or the olher of Ihe TV or radOr 

• Nflove the computet farther away from the TV or radio, 

■ PtUQ the computer inio an outlet that is on a different circuit 
than the TV or rad-o {That is, mal^e certain the oompuler and 
the radio or lelevision set are on circuits controlled by different 
circuit breakers or fuses } 

■ Consider installing a rooftop television antenna with coaxial 
cable lead-in between the antenna and TV, 
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II necessary, you should consul I your dealer or an ejtpenenced 
radio/television lechnician for additional auggestkins. You may find 
helplul [he following booklel, prepared by Itie Federal 
Communicaiions Commission: 

"How lo Identify and Resofve Radio-TV Interference Problems" 

TTils booklet is available from The U S GovernmenI Prinlrng Olllce, 
Washlngron, DC 20402, stock number Oa4-000-00345-J. 



ftadia and Television LnlsrlBrDnce 



Extended Texl Card Supplemeni 



Contents 



Table of Contents 



Wtjo Needs To Read This Suppfement? 

vll Users: A Card Is a Cai6 

vlli Developers How To Use Ihe Auxiliary Memory 
vlll Corienls of This Supplement 
IX Symbols Used m This Supplemenl 



Introduction 

3 Lnstallallon 

4 80 Colurnn Features 

4 About Ihe Auxiliary Memory 



3 



How the Auxiliary Memory Worfcs 7 

7 Addressing the Au!*iliary Mernory 
9 How irie BO Column Display Works 
11 Double High-Resofution Graphics 

Hbtv To Use the Auxiliary Memory 15 

16 The Ejctended Display 

16 Dispfay Pages 

17 Display Mode Switching 

18 Addressing Ihe BO-Column Display DirecUy 
21 Auxiliary Wemorv Switching 

21 Swilchmg [tie 48K Bank 

25 Switching High Memory, Stack, and Zero Page 

23 AuKlllary-Memory Subroutines 

2fl Moving Dala To Aunitlary Memory 

30 Transferring Control To Auxiliary Memory 



Canlenls 



Programming Examples 33 

35 Identirying Different ConfiguraUons 

37 Apple We IdenirficaUon in Assembly Language 

40 Apple lie tdentificalion from BASIC 

41 Apple He fdenLification from Pascal 
43 Storing Graphics Pages from Applesofl 
46 Storing Daia Strings from Pascal 

Index 53 



Schematic Diagram 59 



Extended Teil Card Supplement 




Who Needs To Read This 
Supplement? 



This supplement cames wiHi the Apple He Extended SO-Column 
Teft Card and describes (he added Tealures it has, compared lo 
tlie SO'Column Tei'l Card. Before reading Ihis supplement, you 
should read Ihe Apple lis 80 Column Text Card Manual. 

There are two ways you are likely to use the extended version of 
the SO-Column Text Card: 

• As a user wltfi application programs thai fake advantage ol Ihe 
entra memory on the card lo give you more lealures or more 
sior^ge for yoor data 

■ As a developer creating a program, for yourselt or for others, 
thai wiJI use the exUB storage the extended oard provides. 

Users: A Card Is a Card 

From Ihe user's point of view, the Extended aO-Cdumn Text Card 
Is just like the standard eO-Column Text Card. Oh. li s a little 
bigger, and iT costs more, bul Ihe lechmcal dilterencea between 
the two kinds ol te>:t oards are mostly hidden by software Read 
Chapter 1 of IhJS supplement for an introduction lo tlie Apple Ite 
80'Colurnn Extended Text Card. 

The extended texl card is inslalled the same way as Ifie slandard 
SO-column card: read Ihe ^ppie Ite 80-Column Texl Card Manual 
for directions. 



Preface 



vil 



Wo5[ appJicatian programs run Ihe same wHf\ ellrter card— Jr fact, 
many ol Ihem don'l ever take aduanTage of Itre extra memory on 
ir>e emendeiJ card, Irtev simply use it To diapJay QO cDlumns of 
lext Programs thai flo use the enlra memory may da so 
aulomalically, wilhoul any aclion on your pari, or Ihey may let you 
aelecl opIioraJ leatures or data storage To find out how to use 
tr>ose programs mVy the extra memory, reler to Iheir Inalmotion 
manuaJs 

Irt short, tf you just want To use This card for displaying 80 columns 
of text, and you aren't developing a program Ihal uses the auxiliary 
memory, all you really need To know can be found m IhG App'e Ih 
dO-Coiumn Te^S Csrd Manusi and m tha InsTruclions tor your 
appllqafton programs. 

Developers: How To Use the Auxiliary 
Memory 

The only diHerence beTween the Enlended BO'Cofumn TesT Card 
and the standard BO-Column Text Card ia (he amount of memory 
thsy conlajn. The extended card has 64K bytes of auxiliary 
memory, white The standard card has only the addilfonal l K bytes 
necessary to display 80 columns ol tej<t on an Apple He. 

The main purpose o( this supplement is To provfde you witt^ enough 
information lo use the auxiNary memory in your programs Normally, 
programs used with tha Apple lie can only work wilh the 64K bytes 
of builT-in mam memory To work with the auxiliary memory, a 
program must sel speoial switches In the Apple lie Thai substitute 
auxiliary memory for main memory Neither DOS 3 a nor Pascal 
1 1— system programs for the Apple II— support this memory 
subsTftuTion, so for now your appiicatkin programs have to handle it 
themselves. 

Contents of This Supplement 

This aupp(ement contains the information you need io use the 
auxrhary memory for storing programs and data. Chapter 1 is a 
general inTroduciion; iT descnbes Ihe functions ol Ihe Extended 
60-Column Text Card 

Chapter 2 is a generat descripTion of the design of the Extended 
80-Column Text Card, tt explains how the card works with The 
Apple fie hardware. 
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Chapter 3 contains dfrecHons for usng &>e auwllary memory wFlh 
your programs Most of the information m Cl~tapler 3 adapted 
Iron the Appis /fe Reference Manuat The reference manual i5 your 
main source of JnEormalion about the rnierrtal operation ot tho 
Apple Jte. 

Chapter 4 contains stiort programs that use the auxNiary memory. 
These eKarr^ples are fmctjonaL bul nnl general, you will probably 
want to moOify them for use m the programs you write. 



Symbols Used fn This Suppfement 

special text m tins manual is set o" m different ways, as shown rn 
these examples. 



Warning 

Important vi'^rning^ rippcr^jr in boxE^E^ liko Ihis 



Reminder rnferrnaHon lhat is only InddenleJ to the le^ aopB^ra ii 
boxes liKe Uiis You may want Id skip over such boxes and r«[urn to 
them later. 



i|$fn$ app«/ in iMrgJfwl glcsstt like 

llllB 
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Chapter 1 



Introduction 



The design of It^e Apple lie Exlended SO-Coljmn Texl Ca/d is the 
same as Iha! ol the standard Apple He aO-Column Text Card The 
only difference is that the extended lexl card conlsins 64K byles 
of auxiliary memory (programmabJe meniDry or RAM) while the 
standard card contains onfy IK byle ol HAM The eO-column 
display requires only IK byte ot auxiliary memory, so it will work 
with eilher card The firmware that supports Lhe special (ealures 
associaied wUh the eo-column display is pari of the Apple lie itself, 
and works the same regardless of whicf" card is preaenl. 

Installation 

Installing the Extended eO-Column Text Card Is easy do it [ust the 
way you install the siandard SO-Column Tejtt Card Either card «ts 
Into the auxiliary slol {labeled *ux. coHHECTORfonthe mam togic 
board inside lhe Apple ILe If you havon f installed the card yeJ. 
follow the directions given In the Apple Ife BO-Coiumn Tex! Card 
Menuat. 



Warning 

UeijBf in9ta[l or remove anything Insids lhe Apple \\s with lhe Dowar on 
There ia a small TatJ lamp— an LEO— loward lha back of the mam circuit 
board To remmb you ol Ihis; if the red lamp is an. Turn olf the power 
before you i(o anythinp inside ths Apple lie. 
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The BuHMn firmware lhal supports the flO-column dtsplay has other 
features in addltton to Ihe wider display The Appie fie 80'Coiumn 
Texf Card Msnuaf tells you how lo acfivale the built'lr> nrmware end 
Ihe eo-column display That manual also describes many of the 
Apple lle'3 features. 

You can find more inlormalron about Ihe Apple l(e in Ihe Apple He 
Reference Manuai Chapter 2 includes a descnplion ol the different 
display modes and how lo select (hem. Chapler 3 includes tables 
of the lunciions of the escape sequences and control keys In Ihe 
Apple JLe. 

About the Auxiliary liSemory 

The Exlended HO Column Text Card has 64 K bytes of additional 
RAM. usually referred to as auxiliary memory. A iK byte area ol 
thiB memory serves the same purpose as the memory on the 
SO'Coluinn Text Card, expanding the text display to SO columns. 
The other 63K byles can be used for aoxiliary program and data 
storage If you use only 40 columns for text display, all 64K bytes 
are available for programs and data. 

The processor m the Apple He can only address 64K byles of 
memory. The computer has spectal cjrouita that programs can 
switch to access auxiliary memofy in place of main memory At any 
one lime, locations m the seme G4K address space are In either 
mam memory or auxilfary memory In olher words, even though an 
Apple lie with an Exlended QO-Column Tbj<| Card has a total ol 
1 2BK bytes ot programmatjie memory, il is not approprtale lo call 
an 1 3eK-byte system Raiher. there ere 64K bytes ol auxiliary 
memory that can be swapped for mam memory under program 
control 



Warning 

Careless si^itching ro Ihe au>^iliflrv memofy is aJmosl terlatn lo crash 
your proQfams M fOii want ro use auxiliary mernory m your own 
programs, be sure lo slu<Jv the r^sl of this sufipJement and Ihe relevant 
Inlormatlon in the Appie ife Heference Manual, 
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Chapter 2 



How the Auxiliary Memory 
Works 



This chapter bnelly outlines how Ihe auxiliary memory operates. II 
will help yoy undersland wlial happens when you use the fiuxINary 
memory m your programs 




Addressing the Auxiliary Memory 



The 6502 microprocessor can address 64K bytes of memory In 
Ihe Apple lie the microprocessor s entire 64K memory space is 
laken up by mam HAM (random -access memory). ROM (read-only 
memory)- and I O [inpiJl output), (here s no memory space available 
lor Ihe added memory on the ejtlended text card Inslead. Ihe 
address bus is connected to the au*^l^ary memory in parallel with 
Ihe mam memory To use ihe auxiliary memory lor program ajid 
data slorage. the Apple lie swilches He data bos so lhal it reads 
and writes to Ihe memory on Ihe card instead ot Ihe main memory. 
To use Ihe auxiliary memory to expand the display, the Apple lie 
lelohes data both tram mam memory and Irom auxlliarv memory, as 
described m the section "How the SO-Cotumn DtspJay Works." 

The bos switching for program and dala storage is controlled by 
the Memory Management Unil (MMU). a custom inlegrated circuit 
des^Qned for the Apple He (see Chapter 7 ol the Apple ife 
Reference MsnuBt) The MMU contains the soil swilohes set by 
your programs along wilh Ihe logic circuitry to monitor Ihe address 
bus and to switch lo auxiliary memory for the selecied address 
ranges. 
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Figure 2-1 . ^^mofy Map wKh Aujtllharv 
h^emorv 
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As yoo can see by studying Ihe memofy map in FiQure 2-1 . tfi© 
auxilfafy memory is diviOed into Iwo large seclions a/>a one small 
one. The large Bt secl>on is EUbsriiaied Jor main momory addresses 
512 10 45151 {tzoo through iBf ff). This part of memory ts 
someQmes referred fa as rhe 4SK memory space, and il Is used for 
storing programs and date. 

Tho ot^ier large seel ion of auxjitery memory replaces main memory 
addresses 5? K to (IDOOO Ihrough »ffff). This memory space 
Is called the bank 9wilche(] memory If you plan lo use Ihis part of 
the auxifiary memory, read the seclion "Bank-swilched Memory" in 
the Appis ffe Reference Manuai The swiTchhng for The ROM and 
the IDOOD bank is fndependenr of rhe auKlliary-RAM switching. 50 
the bank switches have the sane sffocl on the aujuliary RAM thai 
they do on the matn RAM. 

When you switch lo the auxiliary memory in the bank-switched 
memory space, you also ger the f^rst two pages of aujtalLary 
memory, from fo 511 jSOOOO ttrrough soi FF|- This part of 
memory contains page zero, which Is used for Important ctala and 
base addresses, and page one, which is the 65D2 stack. 



Warning 

RerriBTntier thai fiddress&s fn page 2ero and Ihe 6502 stac^ switch fo 
auxiliary memgry any lirtie you switch Ihe Dank-switched memDrv lo 
auKillary rriemory. 



How the SO^Iumn Display Works 

Half of the data lor Ihe 50-oolumn display ^s slored in mam memory 
in the normal lext Page 1 . and the olher halt is stored in auxiliary 
memory on [he ejctended texl card The display cfrcuilry fetches 
bytes of data from Ihese two memory areas simuilaneousty and 
displays Ihem as Ewe adFacent characiers. 



Memory pagflE jre 266 Ctyle? long. Dul 
dlipliy pm^w diTTi^ 10?4 bylGS 
e g . iQxr Page^ i. or &^9^ bytes. . 
hign-resdution graphica Page 1 
Gliaplera 2 and 4 at tt^ Appte 



The mam memory and the auxiliary memory are connected fo Ihe 
address bus in parallel, 50 both are ectlvaled during the display 
cycle The 40-column display uses every olher clock cycle and 
letches dala only Irom matn memory The SO-column drsplay uses 
the remaining ctock cycles to process Ihe additional display dala 
from auxEiiary memory. 
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FJgura 2^?. Fetching Data For 
SD-CDlumn Display 
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The byte o1 display data from main memory goes to 3 bulter on [he 
mein logic board, and Ihe display data from auxiliary memory goes 
lo 3 buffer on Ihe extended lejil cerd. When Ihe SO-calumri dispJay 
is on, Ihe daia byles from Ihese buffers are swlfched onio [he 
video dala bus ori alTernaie clock cydes firsi Ihe byte from Ihe 
auxiliary memory, Ihan the byle from the main memory. The main 
memory provides Ihe characters displayect In the odd columns ol 
Ihe display, and Ihe auxiliary memory provides The characters m the 
even columns 

The HO-coljmn display contains twice es many characters as the 
40-column display does, so it has to put Iwtce as many dots across 
Ihe screen This means that the dots are clocked oul at 1 4MNi 
instead ol 7MHz, making them narrower and therelore dimmer on a 
normal video monitor. On a television set, the dol patterns makrng 
up Ihe characters are too close together lo reproduce clearly To 
produce a salisfaclory SO-column display requires a moniJor with a 
bar>dwidlh oi at least -14MHz, 
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aaa slands Jor red, gwan. and Wue. 
ariO lOentiriH a Eypa color monilor 
IFul uses ir>d&p?ncl9nl inpuls for Ihe 



E>!cepl lot some experisive RGB type coJor monitors, any video monitor 
with 3 bandwidth as high bb ^4tJiHz wJU ix & rnonochrom? monitor 
MDnochrome means one color a mgnoc'ircime >/^deo monitor csn liav& 
^ Screen color of whitB. green, orange, or any olh^r smgJe coiof 



Noie Ihat rht5 sprnullaneouS'lhen seQuential fetching applies onfy to 
tlie vadeo-display generation, reading and wriflng for data storage tn 
auxiliary memory la done by switcl>ing the ctala tsus to read onty 
from Ihe card, as descnbed (n the previous seclton For more 
mrormatian about Ihe way the Apple He handJes lEs c^lspJay memory, 
reler to Chapter 2 and Chapter 7 of Ihe Apple He Reference 
Menuai 



When you sefecl mi)ted-mode graphics with SO-cdumn text, you 
wouJO expeci that the doubling ol the dala rate Ihat procFuces the 
aO column display would change Ihe hrgh- resolution graphics Irom 
2B0 \o 560 dols horizontally and cauae Ihe low- resolution graphics 
lo maHuncticn. To prevent Ihis, Ihe logic lhal controls Hie display 
Includes an e^tra cirouil to tores the graphics displays lo be iFie 
same regardless of whether you have sel the soft switches lor 
eo-column lext or lor 40-column lexl. This fealure \5 included so 
lhal you can use QO-column lexl in Ihe m^eti graphics and IgkI 
modes 

For those who would Itke lo have a graphpcs display wilh twice tfie 
horizontal resolution, there f& a way lo disable tire circurl Ihat forces 
normal graphics l^m^ng with 80 column lex I There are I wo Ihings 
you must do to obtain the doubte high-resolution display. 

* InslflN a jumper to connect the two Molex-lype pins on Ihe 
Exiended 80-Column Text Card 

■ Turn on Ihe Annunciator 3 soil switch along with Ihe swilches 
thai selecl the 80-coiumn display and hjgh- resolution graphics. 

Tbfs procedure works only on the Apple He with Ihe Rev B jand 
Jaler] mam logic board, identilied by a B bs Ihe last \si\er ot the part 
number on the back part of the board Connecling Ihe pms on the 
Extended BO-Column Texl Card compleles a connectron between 
pin 50 [AfiJ] and pin 55 (frctki-) on the auxiliary sJot 



Hdw Ihe Au]^jllery Memory Works 




Double High-Resolution Graphics 




Warning 

If you hflVE a Rev A Apple lis. Using an ej-tendeil le>Ll card wilh a 
juitifiQr rtiflk&s (he cofT^HJler moperadlf! You cannot use the doubfe 
high-resdJulSon moclitlcalion wV] a Heu A Apple Jle 



If you have an extended le>rt card wilh a lumper inalalled In a Rev B 
(or later) Apple lie. lurnng on Annunciator 3 and selecbng high- 
rasoluJion graphics and SO-cotumn Texl e! the same lime generates 
a display JS^ng high-resoiulion Page 1 addresses in main memory 
and auxltlary memory al the same Hme, 

The mernory mapp-ng for Ihis graphfcs displey is doubJed by 
columns Ihe same way as 30 column lenl. bul il uses high- 
resolution graphics Page 1 Instead ol fext Page 1 Where the 
aO coijmn teyl mode displays pairs of data byles as pairs of 
characters, double high-resoiulion mode displays pairs of data 
bytes as 1 4 adjacent dots, seven from each b/le. As in SO-column 
lexl mode, there are twhce as many dots across tire display screen, 
GO the dots are only hall as wide. 

Existing Apple II graphics programs do not support this kind of 
display Until new programs become aveilsble. you'll have to write 
your own plotting routines if you want lo use 560-dot orephlcs. 
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How To Use the Auxiliary 
Memory 
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How To Use the Auxiliary 
Memory 



This chapter describes sort swilcfies and butir fn subroutines thaJ 
conTrol Ihe operelion oi tfie auxiliary memory To laK© advaniage of 
the aclditiortal memory, you musi ssl up your programs to operate 
In one pari ol memory whife Ihey swilch the other part between 
main and au>nltary RAM Vour program can perlorm the memory 
switching by means of the sof! swatches described lr> Ihe section 
"Display Mode Swilching" or by using the auxhove end xffft 
subroutines descnbed laler (n this chapler Except for fbese 
subroutines, mosr axisttng Apple II system software [DOS 3.3r 
Pascal 1.1} doesn't support the auxilksry memory. 

Although some hkgh-lewel languages. stx;h as BASIC, can set the 
son switches directly, your programs must use assembly language 
subroutines lo control the auxiliary memory Small assembly- 
language fiubrcutinea can be accessed 'rom a BASIC program 
ushg a call slalemenl, or Ihey can be linked to a Pascaf program 
as procedures or functions, see the exampies m Chapter 4 



Warning 

Do nol atlernpl ro uae Ihe Au^ibary merTiory directly from a progran In 
an inlerprelef JangLtacje auch as BASIC or Pascal. The mJerprfltera thai 
run such programs uae severer areas In main Tnemoryn Including the 
slack and Ihe jero page (f yau awilch lo auxiliary rrwrnory In Iheae 
pages, Ihe Inlerpreler crashes V/hen yqu reSEl II1& sysfero lo slarl 
over, your prograrrr and ulaj^ are lo^l 
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77ie ExtBrtded Display 



Locatlana ^Holi: Thew modes L^e 
hjptihors r> both main anc] auKlbsf y 
msmory The oAfiEZ Swilch la used to 
seleol on? Of Ihe oihef lor fiionng daia 
3w Ehe aecbor "Display Mode 
Swilolww." 



The primary purpose of an BO-column text card \s the generation of 
an ao-column disptaVn so there is a compleie seT of switches rust 
to GonErol the dlspHaV- Other switches are U3ed for program and 
data storage in the au^itilEary memory; they are described later. 

Display Pages 

The AppJe lie generates its ■^lOeo displays from daia slored In 
specific areas in memory called disptay pages. The 40-coJumn-leKt 
and low-resolulfon -graphics modes use ICKI Page 1 and tewl 
Page 2. iocaled at 1DZ4-Z0t7 (hexadecimal »*oo I7r and 
071 {iSOO-tfl F F) ^n mam memory. 

Tlie eO'COlumn text display uses a combination of text Page 1 in 
main memory and [he same page in the aujdhary memory, here 
called Page IX Text Page IX occupies the same address space 
as lexl Page 1 . but m auxiltary memory rather than ma>n memory. 
To store data m Page 1 X. you must use a solf switch (see the 
section 'Display Mode Swilctiing") The buill-in fiO-coluinn display 
routines described in Chapter 3 of the Appie ffe ReferGOce Manual 
(eke care of this swilch>ng aulcmatically: that is a good reason lo 
use mose roulhnes for all your normal 80-column re?tf output 







Ldw^sI 






Display Mods 


Pigs 


Addrtu 


Address 




4a-CDlijmn Texl. 






Srff 2047 




Uiiv-ne™iuiiDn 










Grapdica 






t^F^ 3071 




BO-Columr Texr 


1 




S7FF 2047 




Narmal ^SO^Dot 


1 








H>gl>-ReMlulBO 












2 


S4000 }6lSi 


l^fff 24575 






1 


12000 t^9i 






Hlgh-Rtj solution 
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ExlBnd«d T«xt Cefd Supplsment 



I 

J 



For mlonneliQri aboui Hie hejtiad'd deia 

1^ >lp£rfe J* ffeiyfence Mbpub/. 



Display Made Switching 

Vou select tlie display mode lhar is aoprapnale for your appllcatidn 
by reading or wriling to soil swjfcdes. MosT soft swjtches have 
three memory locations: one for turning the swiich on, one for 
turning it olt, and one for reading the stale of the switch. 

Table 3-2 &how5 the tocstions tire soft switches that control the 
display moties. The tBb^e gives the switch locations in three formE: 
he^adBdmal. decimak and negative decimal Vou can use the 
henadeoimal vaEues in your machine- language programs Use the 
Oecimal values in peek or fone commands m ApplesolT BASIC: the 
negative values are lor JnLeger BASIC, 

Some of Ihe soft switches in Table 3-2 are marked read or write 
Those soft switches share Iheir tocaliors with the keyboard data 
and sh"obe lunctiona. To perform the lunction shown in The table, 

only Ihe operation listed there Sell switches lhat are not 
marked may be accessed by either a read or a write. When writiriQ 
lo a soft switch, it doesn't matter what value you write: the switch 
funciion occurs when you address the location, and the vaJue is 
ignored 



Warning 

Be 5urE fa use only the intlicalea operfllions To manipulate the 
switches. If you read Irom a swilch mafked wrile. you won t get the 
correct dala. K you write to 9 sw<lch marked read, you won t set ttie 
switch you wanted, and you may change soma nUier switch so as lo 
cauaE your program to maltunclion 

When you read a soft switch, you gel a byte with [he state ot the 
switch in bit 7, the high-order bit The other bits \n the byle are 
unpredJclatjIe. I! you are programming in machine language, this bit 
is Ihe sign tjit H you read a soft-switch trom a BASIC program, you 
get a value between and Z55 Sit 7 has a value oM^a, so i1 the 
switch 13 on, the value will be equal lo or greater lhan laS: ir the 
switch IB off, the vaJue wili be less than i;a. 
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Tible 3-2. DiBplay Sort Switches (1 f 
ITiis inode i& cmly elleclTVQ when TEXT 
swJioh e on m inia swilch hsa a 
dkffwent luncllofi wh^n AO^TOitE hson. 
refer Id ne:pil aecllofi 43) Ttils switch 
chHTigea ttw lunchon o< (he pa G E ? 
SwiTch tot addresstfiQ the dtaplay 
memorv on exierded t^i^t rard 





riinClPCin 










TEXT 


On Dlswy Te>cE 
R^ad TEkT SwriGh 


ICO* 1 


49l?l 


-1fi303 
-16)04 


Head 


HIKED 


Oil TONi With Gr^phica 
Of- Fi^l Graphics 
RMd hJXfD Switch 


1C01B 


49179 


-1 6301 
-1 650? 
-16)57 


1 

1 

Read 




On r>eplav ? 
Otf DfdQlay Page 1 
Head PAGEf Switch 


1CCI55 

icmc 


49217 
491S0 


-■\b!99 

- 1 ai p □ 

-16556 


2 

2 

Read 


HIRES 


On. Qraphlc^ = High^ 

Resolutior 
□U Graphics ■ Lqw- 

ReaoJuliOfi 
RsM M rnES Swuch 




(921S 


-16297 
'-la;9S 


1 

1 

Paid 




On Di vi^y SO Columrts 
OK Display 40 Columnf 
Read BdcaL SwiEch 


SCQOS 
SC01 F 


4914^ 
4916^ 
4*183 


-1fi}71 
-1637? 
-1fi3i3 


Wnie 
Read 


BOSTQPtE 


On Slore In AuKttefy Page 
Off Slore in Mair P^qb 




49153 
4917d 


-163S? 
-16J8t 
-1 6360 


WnlB,3 
Write ,3 
Read 



Addressing the 80'Column Display Directly 

ftQitre 3-1 IS the map of Ihe 8Q-column dtspJay Hall of the data la 
stofed tn lext Page 1 (n main memory, and the olher half is alored 
in Ihe same tocabons li^ auxiliary memory (here called Page 1 X] 
The display clrcurlry felches byles trom these Iwo memory areas 
slmuitaneously and displays lham ^quenliaily. Iirsi the Qyle from 
the auxjltary memofy. then the byte from The main memory. The 
main memory stores Ihe characlera m the odd columns of the 
dispfay, and ihe auxiliary memory stores Ihe characters in Ihe even 
columns, for s full descrfplion of the way Ihe Apple lie handles its 
display memory, refer to Chapter 2 and Chapter 7 ol the Appfe Ite 
Heterence Manuai 
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Fof a desuipinn of Qte way tfie hlQh- 
Dfder bll act? cofajF'KleCl bH I'l 

EHul ^ of in* Appte lie Rel&ence 
Manual. 



To Store data direclly tn\o the di^lay page on Ihe Exionded 
eO-Column Texl Card, firsl turn on the sosTORt soft switch by 
wrilirg 1o loralion 491 55 (negalive decimal -i tjei o< heKadedmal 
ScOOl} With BOSTORE on, the page-select awifch PACfl switches 
belween the portion oF the aO-coJumn dfspJay stored h Page 1 of 
main memory and the portion Blared in Pago i X ii> atutrliary 
memory. To select Page IX. lum Ihe soil switch on by 

reading or writing ai iocatim 49?37 {-^6^9'), 1 1:055 j 

Vou'll have to wrtia b 5horf progrBm to Iry oul Ihe fiOSTOfJE end 
PAG?^ 3ofl ^iwiiches When you try lo change Ihese swilches by using 
[he Moniror program, it chanfles them tjeck m Ihe pfocesa oi dispLaying 
the cammands you lype 

If you want !□ use Ihe opiional double- high-reBolullon display 
described in Chaplei 2, you can store data direcHy into high- 
resolulion graphics Page IX In auxiliary memory In a similar fashion. 
Turn on bolh aosTOPE and hiRt^. then use page^ lo swplch from 
Page 1 m main memory lo PsQe IX in aunjliary memory 

The memory mapping Jor double high-resolulton graphics is similar 
(0 Ihe normal high-resolution miipping described in Chapler 2 of the 
Apple SSb Reference Manual, wilh Ihe addilion 0I Iho column 
doubling produced by the BD-ccriumn display. Like the flO-column 
teit mode, tlie double high resolullon graphics mode displays two 
Cytes in the time normally required for one. but it uses high- 
resdulion graphics Page J and Page IX instead 0I lexl Page 1 and 
Page IK, 

Double high-resolulion graphics mode displays each pair ol data 
byles as 1 4 adjacenl dols. seven from each byle The high-order 
bit jcolor-SHlecl bil) of each byle is ignored. The au^tHary memory 
bylB is displayed lirst, so Oala from aujiiHary memory appears in 
columns 0-6. 14-20, eic. up lo columns 547-5&2. Data from main 
memory appears in columrts 7-1 3, 21 -27, and so on up Id 
553-559. 

As in SO column leyt, there are hvlce as many dols across the 
dispJay screen, so the dots are only half as wide On a TV sel or 
low-bandwidlh monitor, single dols wiU be dimmer lhan normal. 
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Display 
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lATien BAMWIfT 9fifl ll*WBD are OH- 
B\jii\aiv (Pomcnv la uoed. when they are 
off. main msnnxv is ised. 



Auxiliary Memory Smtch'mg 

Ttils seclion deBcnbea the switches used lo access Ihe auxiliary 
memory for storing programs and data 



Warning 

TUe display aofi switches flOSTOBE pa&E^, and HIPE5, cHacuSfleO 
here and in lha pjesnoua seclion, are used Dnrnarily (or addressing 
display ddla These swi<clie5 cveEiide Ihie gonaral-purpose s«vitchfcs 
describfiO 1(1 Itiis seclion. so ytiu m.\^1 sel them correctly even il yoirr 
program doesn't usa Jtiem. 



Switching itto 4BK Banii 

Switchfng the 4BK'by[e secTion of memory is performed by two 
solt swilches' R*HRI> selecis main or auxNiary memorv for roadipg, 
and RArtWRi" aetecis mam or auxiliary memory for wriling. As shown 
in Table 3-3. each switch has a pair oT memory locations dadicBied 
\Q it, one to select mam memory, and the other to select auxiliary 
memory Selling Ihe read and W'lte luncltons independenMy maKes 
it possible for a program whose instrucllons are being lelched from 
one 48K-byte memory space lo store data into Ihe other 43K 
memory spSCQ- 



Warnlng 

Before using Ihese smilchaa, you tiubI fully unrfsraTand Ifie eTecIa of 
smilcHfng to aunillary memory For example, an applioallon program 
running in Ihe 4eK bank of auxiliary mamor^ Uial tnea to use the Pullt-ln 
I'O routines by calling Ihe slandenJ \-0 links mid crash even Ihougti The 
main ROM. which conlalns Ihe buill-in t O rout<nes. hps boEn selected. 
This hqppena bacauae the slandarO Imks call DOS routines, and DOS i3 
in the 4SK bank of main mernory. wnk:h is tockecl our while Ihe 
applicanon program is running in auxUtary memory. 

Wrilir^g to the aofl-swilch at localion icooi turns bahkd on and 
enablos auxiJiarv memory for readmg, writing to location 
turns RAHRD off and enables main memory for reading. Writing lo 
the sofl-3wftch at location icOO^ turns rahuht on and enables the 
auxiliary memory for wnhng: writing to location icoa-P turns hahurt 
off and enables main memory for writing By setting these switches 
Independently, you can use any of the lour combinations of reading 
and writina in mam or auxiliary memory. 
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AuKitlary memory corresoonding to leil Page 1 eoO high-reaoluHon 
graphics Page l can be used as pari o1 the 46K bank by using 
RAHff[> and FTitriwRT Ttiese areas in auvjliary memory cao also be 
con f rolled separalely by using Ihe djsptay-page switches sdstqre, 
PAGE?, and HIRES descrFbed in Addressing Hie eO Cdumn 
Display Directly." 

As sftowr^ In Table 3-3, tbe bdstqre swilch fijnclions as an 
enabling swrlch: with it on, the page^ switch 5Blec[s main memory 
OF auxiNary memory. With the hires swilch off. the pag?2 swilch 
seiecis main or auxiltary memory in The text display Page 1 , 10400 
to 107 ff; With hJHES on. the PAGE^ awilcfi aelecis main or 
alJKJl^ary memory in IbkT Page 1 and high-reaolution graphics 
Page^, i^OOO to tifff. 

If you are using both the 4aK'bank control switches and the 
display-page control switches, Ihe display-page control switches 
take pnority. if sostdpf is off, raurd and ramhrt work lor the 
.entire memory space from so^oo to iefff , bul if Bosiofit is on, 
RAH1D and RAHidRT have no effect on Ihe display page. 
Specifically, if BOSTORE is en and hires is off. pageE controls texl 
Page 1 regardless ot Ihe settings of rahrd and AjihwRT. Likewise, 
if eosTORE and hires are both on. pa&E^ oonrrols both lexl 
Page 1 and high- resolution graphics Page 1 , again regardless of 

RAMRD and flANWRT, 

Vou can find out Ihe settings of Itteae soti swUches by reading 
from two other locations. The byte you read at location »C01 3 has 
Its high bit (the sign bit) set lo i if ra«rd is on faoxHiary memory is 
enabled lor reading), or o if tiA^tiD is off (the 48K bloch of mem 
memory is enabled for reading) The byle at location tco^'. has lis 
high bit set to l II rahvjbT is on [fluwliary memory Js enabled tor 
wrIHng), or o If rah^irt is otf [fhe 4aK block of main memory is 
enabled lor wriliogj. 
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FIgura 3-2. Elfecl of Stvilclnno VAMItd Main ftuiilJdrv 
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Ftgure 3-3. Elf«t of SwrilcNng RAHRD 
Ein4 RAltvfiT vrilh AO^TORE and HIRES 
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Switching High Memory, Stack, and Zero Page 



When ll>e ALr?P aoP s^ilch ori. 
aipilrary rn«ror> is ufiad. when il la oH. 
main n»inaiv is used 



The aingle soft swiTch rltzp (sHemale zero page) iwjfches me 
bank'3wilched jnemory and The associated stack and zero page 
area between marn and aumhary memory. As shown in Table 3-3, 
writing to location ICOO? turns kljzp on and aeJecls auniliBry- 
memory slack and zero page, wfiling lo Ihe sofl switch at tocallm 
icaaa luma aitzp off and select3 main-memory slack and zero 
page for reading and writing. The sechon "Auxill^y- Memory 
Subrojiines" describes firmware lhal you can call !d help you 
switch between mam and auKlliary memory 

To find oul [Jie setting ol this 50'( swItcJi. read location tto^6 The 
data byte you get has Its higTi bil (the sign bH} set to i if altzp is 
on jlhe bank'swilched area, slack, and zero page in Ihe auxiliary 
memory are selecledj, or if altEp is off fihe same areas in main 
memory are selected), 

To have enough mentory locations lor all al the fiofi switches and 
remain compalible with Ihe Apple II and Apple II Plus. Ihe sofl swi^chas 
Isted in Table 3-3 ahare Iheii iriemory Jocaliona w<1h kevlward 
funcHona lisled irr Cl^apter 3 ol Ihe Ai>pts fle Reference Msnita! 
Whichever aperalion— read or wnle — is shown in Table 3-3 lor 
controUinfl Ihe auxiliary memoiv Is the one itiaf is net used for reading 
the keyboard and ckeju-ing the strobe. 
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Tbble S-3- ALjK*ary-Memorv Salecl 
SwitctiGfl []) When aosTORE i$ ofi. n>e 
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Fi^kire 3-4. Ere^cl al SwitcNng ALTZP 
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AuxiUary^Memory SubroutinBS 



If you wsnl lo wnie assemDly- language programs or procedures 
that use auitiJiary memory the buJHn auxilrary-mBmory subroutines 
will be helpfuf. Tneee siibroutines make it possible to use the 
auxiliary memory wplhoul having to manipulate the so'l swilcbes 
alread/ described. 

The suhroutln&s described in Hils section rriahe hi easier use auxft^ 
memary. bul Ihey Oo nol prol^cl you from errors Vdu 3DII have Id plan 
your use or aQKlHary memory lo avotd tnexpiicaWe crashes. 

Vou use these buHl in subroutines Jh© same way you usa the i 
BubrouI^^es descrrbed in Chapter 3 ol the Apple tie Reference 
Manuaf by making subrouhne calls to Iheir starting locations Those 
loGSlions afe shown in Table 3-4 

Tdble 3-4. AuwIlary-MarrtOfy RDuVnes 

Submi/llni 

N»mi Locailon Description 



auxiMa/v rnefnory 



XFEH tC31« TranslHS praQrain conlrcl Delween 

main And aUKJlsry rn&mOrvi 



Moving Data To Auxiliary Memory 

In your assembly- language programs, you can ose tJie buiJt-in 
subroutine named Ati^hove lo copy blocks ol dais from main 
memory lo auj^iliary memory or Irom auitHiary memory to mapn 
memory. Before ceiUng Ihls rooHne. you inusl pul [he data 
The cATFf bti bt[ in me processor addresses into b/Ee pairs in page zero and set the carry blE Eo 
aifliLs wofd. uaa th# SEC instrucHon to select the dir^c^^on ol fbe move— mam lo auxiliary or auxiliary lo 

main. 



aei It. :ic TO cteai il 



Warning 

Don'T Iry to aukMOvE lo copy dale In pa^e zero, page one llhe 
6503 Slack)- of m ihe banh-swilched memory flDOOO-t f f F F) 
AUflKQVf uses pcige zero while H is copying, sg i| can'l handle moves 
In the memDry space swMcned Dy *LTzP 
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nBnwmber thai Pascal uses Deg« z^o loo. so you use 
AUXHOVE froTTi a PaBcal procedure ^il>iQUI saving rh? conlonta of page 
zero firal. ^cl rdsloring tt\em afterward. 



Tibia ParameleFt Icr AijXHOVf 
i^wbTbe 



The pairs or byles you use tor ps&sing addresses Co this subrouEioe 
are caJled *i, AZ, and they are used for passing paramelers to 
severaf of Ihe Apple He's buiit-in routines. The addresses ol Ihese 
byle pairs are shown in Tabte 3-5, 



Mam* Locallon Parameter Phased 



CaiTv 1 » Move Prom mffn to aosHififV mwnory 

Q = Move Prom auxiliary Id main meniDry 

Al L 13 C Sourct Sorting addreas. low-order byle 

Source darting addr^&s, hrigh-order byle 

AZi. SIE Source ending ^aKsss. 4oM-order byl* 

ASH Sourc* ending address, F^gh-order b/le 

jl4L S^i DesUfiabon sfartlng ^dress, ^ow-order by» 

fttH Jil Deslmahon slarting sdOress. rugh-ordar byle 



Pii\ Ihe addresses of the lirsi and l35l bytes ol [he filocK ol 
memory you want 1o copy into A1 and A3- Pul Itie slerting address 
□f Ihe block ot memory you wa/it to copy the data lo inio 

The AUXHOVE rouline uses Ihe ce^ry bit lo selecl Ihe direction to 
copy the dala To copy dala from main memory lo auxiflary 
memory, set Ihe carry bil [sec}: lo copy dala from auxiliary memory 
to nam memory, clear the carry bpl KLC|. 

When you make the subroutine call to auamove, Ihe suProuline 
copies Ihe blook ol data as specilled by tho a reQislers and Ihe 
carry bri When tl ^s Ijnished. the accumulator and Ihe x and Y 
regrsiers are just as they were when you called il. 



Transferring Controf To Auxiligry Memory 

You can use Ihe bull! in rouline named K F E H to Transfer control to 
and from program segments In aunlJiary memory Vou musi set up 
Ihree paramelers before using KF£fi: the address o' the routine 
you are transferring to. Ihe direclton of Ihe Iransler (maan to 
auxNiary or aujfillarv lo main}, and which page zero and slack you 
want to use. 
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Cairy 1 ■ Tranftter Train rnflni 10 autalery memorv 

= Trans'ar trofvi uj<lkarv to main memorv 

OvbHIOw 1 = Usa paga zero ^(T slack in aui^iliarv mepYiory 

■ Use page zero and slack m m^in rri^mc>rv 

SJGb Pragrain starling address, low-order byle 

sl£E Program ^Urlmg address hign^nrder byic 



Pal th€ transfer address inio the two Dyles al Jocalions s'ito and 
»3E£- wjfh the low-ofder byfe tirsl as usual The direcrlon of the 
Iransfer is conlroHed by Ihe carry bit: set the carry bit to transfer to 
a program in au)^ll^a^y mETtiory, clear Ihe cerry b^t to Iranaler to a 
program m main memory Use the overllow bfl lo select which page 
zero and slack you want lo use. clear the overflow lo use the 
main memory; set the overflow bit to use the auxiitary memory. 



Warning 

II IS Ihe prQgramrnef '3 respanaibility to save Ihe curreni stack pair>ler 
somtn-vhErs in the curreni memory space before using KFER and lo 
roslore lE afler rfiga-ninp conlro* Failure lo do eo will cause program 
errors 



Alter you have set up E^e parameters, paES control lo the X f Ef^ 
routtne by aiump mstruclion. rather than fl subroutine call xfeu 
saves Ihe accumulator and the transfer address on the current 
3tacl<. then sels up the soft switches lor the parameters you have 
selected and jumps lo Ihe new program 



Tlie irtarflDiv bit j& W b in lha 

prcac9B£Qr fliafiia word, ua^ Itic clv 
hfistructnn tD Clear it To »e ie. iQfce an 
Qvefflow by adcling tu^ juj^nbers Uial 
lotal morft tlian 1 27 
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Chapter 4 



Programming Examples 



This chapter contains examples showpnQ hovi [o use The auxiliary 
memory from a orogrem These examples are rol inlenOefl to be 
universal rouQnes that everyone can use as ts, rather, they are 
represerlaEive examples showing how specific cpeiallons have 
been implemenled Vou will probably want \o study the examples to 
gee how it is done, then copy or modify them lo slifJ your 
appllcallon. 



Identifying Different Configurations 

By iderhlHylng the conNguratlon o' the machine Ihey are running on. 
application programs for the Apple lie can take advantage ol Ihe 
new features and sllll remain compallble with older Apple ll's This 
section gives a procedure for doing this trom assembly language 
and Shows how lo use Ihe identification routine in programs written 
In Applesoft BASIC and Pascal. 

The identiflcarion rouilne returns a value to Ihe calJmg program tt>al 
depends on the type of machine It is running on. Tabte 4-1 shows 
the return codes. 



Tsblg 4-1. Jdenlitlcation RBWrn 

100 [Q) - rMit an Apple lie 



laQ [II] - Apple lie bul no Apple lie SO-Colurrvi Ts<r Card 

14Q - Apple lie tUiFh SC'Column Te^r Cord wirhoul auiirflarv mamary 

lao [1 ZB] - Apple lie wiEh E.ilended flO-Columii Tetl Card 
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Nola: An BO tduinii card insfalled in ejipansion sJoT 3 will work in Bn 
y^pis He the same as in an AddIp <i Of Apple II Plya, bul It does nol 
flcrr^ale Ihe tnjUl-m SQ-column rirmwarH The idenlrticatiofi proorain doaa 
nol detecl such card, DljI rsturns a code ol 3? no Apple He 
SO'Calumn Texl Card. 

Hare Is an oulline ol the procedure me IdentilicflHon routine uses \o 
identity an AppEe We and Its variations: 

1 . Save lour idenlifcalton bytes from the ROMvRAM area (idOOO 

to (FFFF). 

2. Disable mter^upls. 

3. Switch bank-switched memory to read ROM by reading icOSfl 
twice. 

4. Identify Apple lie by finding thie vaJue 06 at SFeei- 

5 If Apple lie. and high bit Is on at location SZD^7. then Ihe 
computer tias a tent card. 

6. H Apple He witti flO-Column Text Card, then check for auxiliary 
memory. 

a. It lcOi3's high bit is on, then reading auitiltBry memorv so 
must have auxiliary memory . 

b. II icoi6's higti bit Is on, fhen reading auxiliary ;ero page 
so must have auxiyary memory. 

C- If sparse merriory mapping Ino upper four address bits so 
that iBOi} has the same RAM localion as icOO), Ihen no 
auxiliary memory. 

1 . Fuchange a section ol zero page with Ihe section of 
code thai switches memory banKs. Thia way tbe zero 
page data is saued and the program doesn't get 
switched out. 

2. Jump lo the j-ekicatsd code on page zero. 

3. Switch In auKlllary memory [1200 - isfff) for reading 
and wriltnff by writing to scofl^ and icODJ 

Mote: AuJiilia/y memory locations iftOO-ssoa and 
i2i]Ci0-ift0oD may not be available dependtng upon 
the selling oi soft swilches tor 80 column display and 
high-resolution graphics— they have pncrity over 
auxiliary memory selection 
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4. Store a value at tsoo. and see if same value at scoo. 
If not, Jhen fluwltary meimify. 



5. Change value a\ tcoo, and see il 1800 changes to 
same value. If so, then no auxilparv memory. 

e Set soil switches tor readrng and writing lo main 
nremory by wrihng to icOOS and 1C004. 

7. Jump back Into program on main RAM 

S- Put zero page bach. 

7. Store idenlrficalion byte for later reference by calling routine 

Q It Pascai routine then furn cerd back on by reaOfng ic OBB 
twice, 

9 The BASIC or assembly-lsnguage routines restore fhe 
ftAM ROM area as it originally was by checkinQ four byles 
saved a! Ihe start of Ihe routine. 

10 Enable Inlerrupta. 
ti. Return !o caHer. 

For some applications it may not be necessary lo identify the esact 
contiQuratlon ol the compuler. For example, if your program cannot 
use Ihe auxiliary memory, liien you would not need to know 
whetber it is available or not !n thai case you may want lo eliminate 
parts ol ttie routine For other applications The idenlificalion routine 
will use memory space required by your program, so you will need 
to move the routine to some other location 



Warning 

If you change the identlffcflllDn routine, maKe sure Ihat il still Oetefmlnes 
Ihe contiguraEiori in Itie sane way as Ihe onglnal |_a]pr revisiDna ol The 
Apple lis may net support other frtentlticallon pFocedurea 



Apple He identification in Assembly Language 

The assembly-language subroutine given here ts assembled lo 
machine language in kicalions t^DO through S3 C F, To call the 
subroutine, your program does a jump To subroutine (JSR) lo i2i>4 
When the subroutine returns, the fdenlificalion code \s stored in 
memory location Hcf. 



Programmina EHocnpIvs 



Apple Ike iiJfln|jHc0lhCin Prografn 
190? 





W ™ "r 






SAFE 


EftU 


13 CF 




S JtVE 




10(^411 


ilTAUT CDtJE AEl-OCATED DN PAEE ZErQ 






120C 


'START or FOUR ATTE LAHEiUl^Qf Ci^FeP [D 




PHP 




StUfAtLf INTERRUPTS 




III 












jSME 4 STTEJ FRQfl 




}rik 




7flOPItAF4 AREA FOR Ll^tEK 








;flE5T0fllHC RANHQH 

H ■ ■ m m m m m m ■■■■ ■ 






&AVE+1 


] TO OHIGINAL CONDITEQN 












$Ti^ 








LD^ 








(Ti 








LQl^ 


tCDAi 


;E4Sl|I^E lEADIHG RQPfHV TURNlNC OFF 




LDA 


IC[>#1 


:IJl«PlJliL£ HEIR. 








;EET- riP[>LE HE SISNATLmC BtTE 












^ ™ » 


flUTl 


;IF MOT THEN Rpt i^PPlEIIE 








IVI^S AO ^ClLllNRf FOUND DUHINC STASTOP 

mm m m ■ ■ ■ h ■ ■ ■ 




AMI 

Ir I 


Out; 


'[F HI BIT DN THEN HO AO CD LUPiH CAtttf 




■ " 


tcai 7 


-£EE IF AllH PtEPtQRY iEFNti REAO 

H ■ ■ ■ mm mm ■ ■ mm m h ■ ■ m m m h 




■ rt 1 


auT4 


zPtUl hEH tEIHC USED AUX HEN AVAIL. 




LDA 


ICQl & 


rSEE IF ZP BEINC U^EP 




iH 1 




'AUV B£ING USED ED AUX AvA [ L 




1 DV 


'vwriL Jinn' 


'RDt suhE tet so keep cnecking 


IT T 


1 Dt 

■ %■ 1 




-SUAP &ECTJDN OF Z? tflTti 




IDA 


SAFE-1 i 


[CDDEJIEEDINE SAF^E LDLIi^TCON ^URINC 




T> ' n 


^ n ■ t 1 I r 


"RfAD AUl PlEll 






V ■ ri 1^ 111 














■ne 








JNP 

in r 




'JUNP TD safe CIDUliD 


On 


PHP 

r ■! r 










'[>DN^^ START 


:KaVE ZERO PAQE tiOE 




LCA 








STA 


SAFE-1 V 






DEV 








■ HE 








PLi^ 




jEtEt ^AcK STATUS 






□ UT3 


fCAAflr jET SD AUH Ht^^ 




1 

^ Ir " 


V hr V 


"HAOE ]T SO There is Aiij heh set 




S Tik 


PA RAH 


tPAVAHElBD 






Out 




DUTi 






.-AO CHLUP^NS BUT ND AUIT SET 






PA PAH 


m biDiHH.±ll^ 

] PAflAM***0 




JHP 


OUT 






LQlk 




jA4>fLE HE BUT ND tARD tET 




\Ti 


Pl^RAM 


|P4I^AI1-IZC] 




jhP 


flUT 




curt 


LQA 




JMOT AN APPLE II« SD SET PARAR-D 




5TH 


PA^Ah 
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OUT IDA lEDDD flF ALL & BYTES t^E Sl^^E 

CHP fAVE ;TNE lAHaUA[;E CARD NEVER 

BNE aUTQN ^yi^SOM^DDOHOtHlNG 

LElA tCdClD 

CMP 3AVE^1 

BNE QUTQn 

LDA Id^flCI 

CHB fAVE^f 

BNE auTQN 

LCA iDpgn 

CNP 1AVE^3 

BEI^ fiODUl 

OUTON LChA SCAit ;N0 HATCNp tUtTH Flf^&T 

LDA »EDDD ;«ANi: DF lC ON AND CHECK 

DUTONd 

LDA ICOAO 

CUTDHD lDA iDlkOO 

SJ^VE+1 a IP ALL lDCATIAN^ CHECK 

BtO OUTQm jlHEK NDtHlNQ HDAE 

LDA t^DBD ;DT^&FrvUt TuITh DN BANK Z 

OUTQUI I.DA ID^QD |LH£LK ±£cDhD IVTE IN Bi^Np: 1 

CUP 5AfE+Z 

iE4 OUTONZ 

LDA ICQBO fSEL(CT ^kkK 2 

JHP SOOUT 

ODTDij? L&Jl IDftOI? jCHECK THTKH PVlE IN BANiC 1 

L[hA ICOIO a SELECT BANK S 

liCOUT PLP ^flESET INTEq^kfl^TS 

m s 

-"-^ BOUTINE RUH in ^HFE AIEA NOT AFFECTED BY MQVES 

START LDA -BEE jTPr STORIHt IN AUH MEh 

IT A %Z00^ JVRIK TO ^UH MM| LE ON MAIN ZP 

;TA ltDD3 ;tET ID H€AD AUX RAM 

StA IBOO -CHECK FDR SPARSE PiEH NAPPINQ 

LDA tCQQ ;SEE IF St^J^USE MEHqa-^ -5AHE VALUE 

CHP ^lEE ; IK AHJiY 

BNE AUkHEH 

A5L iCQO ;HAT B& 5 Ml 5 E NEH $0 CHANCE VALUE 

LOA t^QQ H ^ hlHAT HAPPENS 

CHP ICClCl 

BNE AUX^EM 

SEC ;SPA«SE HAPPING tO hCi AuH HEM 

tZl BACK 

AUJiHEN Ci,C :T^EAE KUt HEfl 

eACK tlA ; SHtTCft EACK TQ UR|TE flAIN RAM 

STA tCOO; ^SHITCH BACK MAIN RAN READ 

JH|» on ^COHTIMUE PNaCHAH ON PG ) HAlN RAH 

DOHE JVOP .fltaaFPELDCATEDPPQEBANHAflKEft 
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Appie Ue Identification from BASIC 



One way to identify rhe conngiiration □( an Apple We from BASIC is 
to load [using h lord J the machkne-code version ol Ihe asaembly- 
Jangijage roulme de&cnbed in Ihe prevtous seclion. )hen execute a 
CALL atatemenl to location 7?4 (i£D4j. When the subroutine 
returns to the BASIC program, executing a peek al Jocalion 975 
(S3CF) gels the result. 

Here Is anotfier appnDSCh to writing a BASIC program to identity the 
type ol Apple fl it is running on. In this program Ilie i^£semb^ed 
code for rhe assembly-language idsnWIcalfon routine from the last 
section Is included in the data stalemenls. 

AppJe JIfl IdEntilicalion Tram 

aiz, ut , iifl, 2, ira, 0, zii, iti, 173. i iq?, 1?^ , izs, 

1?3, 179, 251 H ifll , fl, ?Sh 173 

?□ DATA 23, IVZ^ AD. 173h IVj 192, ^M, 173> S^h 1?4!h 34, 160^ iZ^ 

1»0, U?, 3. IBS, tth fl^ 150, 1 53^ 162> 3h l5fl- 20e, £45 h 76, 1 , C, 

B, IAQh 42, lltS, 3, 
ja BATH C. a, 136 H 2*?. 1tt4> 1 7t, B, 1 ftfl , t?B, HI , 2 ft? , 3 r 73 ^ 3 h 

149, itn U1 , 207, J, 74, 73, 3, 1 tfl , 3 a , 141 ^ 2<J7> 3* 73, 3, 1 , 

fl, Itl , ?07, J, 173+ 0, 22^ 
40 DATik £4^, 24Bh 2^, (h, 2Qfl, 2QS, ZD?, 1 A , 1 73 + , ?f 

2(1?, £10, ?H 20fl, Eh 173 , 0, 214, ZDS, ZH , ?r 240> 3t, 1 J3> 13*^ I'Z, 

173, 0, 274 H 203, 20B, 2, 240, 4 
30 DATA 173 J ISa, IflZ, 7t, 1*1 , 1 73 ^ ZQS, ZflS. 20*. 2h 2^0 h 6h 173, 1?B. 

1«j 7fl, 161 H 3, 173, 0, 21 2, SOi, 210, Z, ZiO, 4, 173, IZi, 192, 7fl, 

141, 3, 17>, a. Z16, 205j Z11, Z 
60 DATA 2il>, 3, 17J, 1 23, IflZ, ^0, fl4H 14^- Z3B, 141 . 5. Tfl2p t4l , 3 , t92, 

14T ^ Oh fl, 1 73 ^ , 12, 201 h 231, 200, 14, U, 0, tZ, T 75 , D, ZOl, Op 

12, 20a, 1, 54, 174, T ^ 24 
70 DATA 1^1 , 4, 19Zh 141 , Z^ 192, 74, Z9 , 3, ZJ4 

AlOOK n: 97 5;lTAflT - 7Z4 
90 f ON I - TD 249 
1 DD dCAO »TT& 
1 1 a POKE START + I, BYTE 
1 20 NE^t 
13D CALL STHFtT 
TiO qESUitS - PEEl FAiOOf) 

l^D tiMlNT HEtULTiF flENBESULTS DFOMEAN NDT A HE,' 32 PVEAHS ^IIE OuTHOAO 

COLUHUS; 64PtEAN£ HIIEUITH BQ CDLUHN5 BUTHOAUK M£Hj 1f4HEAHaA]JE 
y ITM AUJI NEP 

14D f ND 
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Apple Ue Itientiflcation from Pascal 

Here The assemtsly-language idenlhllcation program previously 
described in Ihe Toffn o( a Pascal procedure. 



POP 



4- 

-ENDH 

k 
P 

t 

F 

.FUNC 

SAFE xGQU 

F 
F 



-1+T 



Q 



;S,IVE ^i^SCAL ItETURN l^DDrtESK 



STErtP Srolci^at op HCTUIM to pascal ADD^E^i 
J^TAHT OF C1]DE HE LOCATED <lk ^A&E JERD 



POP 
PHP 
LM 

Lhp 



IDA 

4.DT 
LDX 
LDA 
ST?! 
!TA 



OUT! 
DUT7 

auT4 

iAf£-l it 

^AFE-1 
*T*ilT-1 ,T 



jLCCPt OL>T INTERRUPTS 

;EHtURE HEADINi POn S'i TuRhlNi; DFT 

rGEr APPLE ] ]« ilSNITUIE BtTE 

MF HOT Tll£N HOT l^R^lE lit 

;Hl^S aO C&IL>HNS FDUND DUNlNlj STi^flTLPP 

; IF »fIAH BIT DH tHEl HO eC- COLUMN CURD 

;SEE if AUX HtH^RT BEING READ 

;AUX HEH BETIfi] USED SO I^UT Htii AVAI L 

;BEE IF AUir ^P BElHi USED 

;AUA ZP frEIil& USECr £0 AUX HEB AVAIL 

;NUT SURE TtT S^ KEEP ChEC^INC 

sShAP SECTION GF 2P LIITM 

;CC[^EHEE[^|li&, SUFE LOCATIUN DURING 

;READ AUH HEU 
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H 







■iP 






1 


V i [ X 

J H r c 


h 1 drill ftxrc rftj^iiun 

jJUHr 1 U 3nrc urtUUPILf 




rn r 




L ft 1 r h" curiH X r F Q n 1 1 H n txL/c trxtiic 

^Dft^Pi ^mj" jnTC atUUnUL 9n1C DlnPUZf 




1 n M 




.urBiJ^ ^£Dn HL^E UJ^V 

|l^43f E ZEHD PflljE inCK 




1 h i 


E T i ^ T 1 V 

STJiflT - 1 J T 






A 1 & 


g ft r C ■ 1 , T 






^ t T 




















■TlFT ■X4~h' TtXtll4 




H r ^ 








1 n i 

L. Lr Ji 


' B LI 


^IliriE TT Cn TLIE[>E XI hV HE ^ C T 
^PIJiLfE 11 3U in^ftt la i^LTJi ^E^^^CI 




K ^ i 

* ta 


P nil Jin 


j'PllffllH"JiD 




1 miM 

Jmr 


OUT 




All T 1 

CUT J 


1 h A 




rftn r'AliiUliE AilT bn i^lV IJI C£T 

JBO CDLUHN^ PUT NO AUI^ 9|f SET 






r ft rtJin 


h Eli ftiHnE^n 

1 r ft n ftn ^ * * U 




1 H B 


n 1 1 T 

OUT 




VW 1 £ 


1 ni 


^ t w 






1 T t 

M \ n 


r Ji H Jin 


f rJi K H H ' ■ £ u 




1 H B 

J H r 


n 1 1 T 
OUT 




OPTi 




^0 


;H43r AN APPLE lit SO SET PAHAH'O 






H A k A U 




□IIT 






l&Er PAfCAL BACK 
















JnEACTIVArE INTEnnUKT& 




1 1^ * 


'0 


|PLJT IN niLin AVTE or REaULTl 












1 nA 


r ftH ft f" 


hSIriT CmiUEi WXri HE TH 1 flU EVTC b DIKU 

^rtll rLrUnV TnLUE IH LUW DTIc a rUSFI 












1 lii 


PCtTUPIIp + 1 


JftEfTgHE PASCAL NETUPN nOD 












LH 


RETUHM 














PITS 








_»YTE 






i 

] VDLtTINE RUN 


IN SAFE PJDT i^FFECTEE? lY HDVE5 


F 

4T,II1T 






;T(1Y STORING . IH AUX HEPI 




JTA 




llrfHITE TQ AUX VHILE OH PIAIH ZP 




tTJ 










a Add 


:CHECi: FDR SPARSE HEH HAPPIJIEi 








r5E£ 11= KPi^RSE HEHaVV-lAHE VA|.UE 






'Dee 


I 1 K AUAV 
















:HiY BE SPARSE H^M CNAlLCE ^JlLUE 








j A 5EE ¥\f$.T tlAPPEHfr 




CPTi 


occa 






INE 








itt 




SSPAHSE flAPPiNC SO HO AUJf ^GPl 




■ Cf 


■ Jici: 






CLC 




aTll£llE IS i^Uic HEH 




3TA 


OC0Q4 


JjlillTIIH lACK T13 H4ITE HAIH HAM 




STA 


OCOOZ 


S^tflTCtl AACK HA[IV MH ^EAO 




JHP 


ON 


^CONTINUE PRDGRAH DM ^ NAIN RAH 


DDNE 


Hc^p 




}tHf^ DF RELOCATED PRO&RAfl HARKER 











ExtenOad Text Card Supplement 



Storing Graphics Pages from Applesoft 



Hi-nes Page Merer Tui JhuvlUarv 
tftmort Dsnto- Using -uhihime 
SubiDuline. July 19B2 
utM - Hi byTe of "U*. laat. (Page ' 
Hmea 32 J. 

Call puiBAn Id copy N-res giaphlcs 
page lo jiuii. hem. localion specilAd by 

Call ecTPAt To load hi-iea araoi^ics page 
liom xtin. HEH. iDcehon ip^i^iliBd by 



II IB generahy not pracIicaJ 1q use Ihe ajxihary rnemo'y from BASIC. 
A BASIC program can only move \\s variables in memory by getllrtg 
very Xncky with peek and poke commands, an approach that is 
both ineffiGienl and d^garous, 

Thsre 15 one form of Oala lhal uses lata ot memory and is simple 
enough to handJe from Applesofl; hrgh-resolution graphics pages. 
The auxiliary memory is an ideal place to slore as many as tive 
complex graphics pages Eor rapid loading into the display buffer. 

Like afJ ol these examples, fhe following Applesoft example 
includes two short assembly- language subroulines The lirsi listing 
la the assembJy-language form of Lhe subroutines The second 
listing IS lhe Applesoft program with the machine -language 
subrouHne inciuded as a seriea of d*ta atatemenls Thie method of 
adding a machine-language subroutine lo a BASJC program is not 
very efficient, but it is convenient for short subroutines. 

Tl%e program has two phases in lhe first, the program generates 
five dlrferent high resolution views and Btores them in aujflliary 
memory, in [he second, the program loads lhe slorefl graphics 
pages bacK into main memory one allEf another 





D&ECT 






□ HQ 






OS 


; 




D£ 






DC 


3 




OS 


2 




[>EI|0 





AUilHOVE EBU tC311 



-* HOVE MI-HEJ fHflE TD KUI PVEPl: 
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IT* 



'{PGIBEG 

snciEG+1 



ITi 

ITJi 



'<PClEND 



SPACE ENDINi 
^JlDttl^ESS 



DE^TINATIDH JL^^DHESS 



DEStlEQ 
HARM 

CiGSTIGS + 1 



jDESTIHATIDJi 



# U^E AUUhD^E ro DO IT: 



^EC 
■ TS 



LDA 

LDJi 
STA 



'^PtllEC 
^'PCIBEG 



SttGSriMTIOII 

|£GII|IIIH« 



* PAIN ' KOUrt^t ADDflCSfCS 



LDA 

LDA 
5TA 



SNCIEQ 
PAPH 

&RCBE[;+1 



-PAHH FDR 

pSQUNCG iESINNlNG 

: ADDPESS 



LDA 
9TA 
CLC 
LDA 
ADC 
3TA 



ai^CEND 
PARfl 

IRCEHD+I 



SCOWUTE SOUPCE 
fENDTNG ADDRE$$ 



U&E AUXHOVE TO CD [T: 



CLC 



AuxnavE 
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lor llie Appfe 11^ Exf^rtdgd SD^Golumn 



09 

100 

107 

108 

11)9 

1 1 T 

tIA 

tl9 

T?7 

>fA 

U9 

IID 

14D 

I7a 

198 

EOO 
21Q 

2«« 
300 
31D 
320 

laoD 
iei2D 

1030 
1040 
1P95 
1999 

2029 

2CI4D 

3100 

zizd 

2990 

30411] 
SIdO 
3200 
3990 
39?4 
4000 
^C2C 
4640 
40^? 
4D&0 
it!M 
4100 



FtEH 
R£l1 
REM 

REM 

REM 

REH 

REM 

REM 

REfl 

REM 

REh 

TEST J 

PRINT 

AON 

REM 

DATA 
DATA 
OAfA 

M£H 
VEtt 
tiAtri - 



fivf C4C14¥ gf tHr hi-Rri p4t« in Auji4i«r^ AtiDQry. It thfn 

rot II L ng g I . 



HONE 
CtlHt 



MTl: (IEPffTRL-0 for 40-£CilunndiEpl«»> 



169h0h133,40,149,3Z,133,41 ,14fl,243.1i3jfi?,1fiflHfiS- 

63, 1S5,D, lSS,flfi,l?J,0, 1,1 JJ.Ci7.5fi,32, 17, 195 H9ft,0 

169,(], 133, aa,ia9, 12, ni^fi?, 149, 0,1 33, 40, 173 ,0,3,133 

41 H 149. Z^S.I 33,42, Zt, 171,0,1,1 D5.J1 . 155^63 + 24^52,17, 195 

-9* 

RE^d the PBflBr ^ub^^autine^ and Etarr it 1?0lr 
74E;PliTPJ6& - 749:«R|U0PA0E - «DD 



FOR [ - 4 TD 6^ 



,iVTE 



HEJIT 



I 



up C Qri&t int E f g r 

f^I « l-14119Z6StPZ *i PI 2 

SP V p2 9^ REM ani]L« bctuccn fitrldians 

SP 3j REH EC^rcIng angLf incrv^ivnt bvti^TVn vifus 

OT = Pi 1^^ RE14 itgnfnt »ixB [hnyLff} fbr dhAwing neridlani 

i * 1: REHSeni-naiof rmIe af «Ukp«v^. 

MEN 

HEM LQDPEtflrKingat JOOO drivv Vlfuv and ttn^rCl thCi: 

POI^ V]EU - 1 TO 5 

t HER HbR «^a5« pr#f1oufi ^ifu: 

t HSR t HCOLOR* 1 

I REM Dra»J picture franac 

+ HDLOT 40, 1^^ Z19,119 70 2l9,0 TO 60,0 

r VTA( Z3: HTjIE Q 

L PRINT ...tcniLruCLing # ;VI£H 

t «E» 

. EP * VIEU: REM different starting «ngLt tach Mitu, 
F MEH Loop vC^rting mX 30011 drAul «»r Ml am C»L L hpiei) ; 
t FOR lANCLE - [>P TD PI ^TEP 5P 
: - COS C UN^Lt) : 4EN Sv-h-BLngr akii 1 i^f «M 

c cFIHHT - 1 ; R^H fpr pLptt ing 

t : 

FF MEN ippp itflrEing at 4000 drAut a Atrldtan ttLLip^e): 
LL F-DI THEm - TD PI ^TEP DT 

J.ET k - i * EIN CTHETA5 
t t : LET f * ■ * COS ftHETAl 

Ft: REN Ne.it ttaCt Lhnei atitfi PX and Pr far platting. 
L t t LET PX H # ^5 140 
t ; S LfT PT * Y * 55 + BO 

E E E IF URST THEN HP LOT PH , PV i F I RS T w 



Programming Ej^ampJes 



411*1 jff]FhQT"FiflflTTHEW HPLOT TQ PT.PT" 

^2^11 t t n€Xl THETA 

43Dl} : 4EIIT lANCiE 

: VTAI 23: hTAJ g 

^^[>[> : HEP* PuE ^Iftf duMi Liar-y nfln^r^^ 

^31D r PDUE P^hN.VIEU 12 

: CULL vutpaqE 

4400 PlEXT UtEir 

^AB? REM 

4490 rtEH Piuf vi«u$ ^tnrtfd" Pflw ahoy thtn: 

4700 HDHE t VTAI ?5 

4720 hTAB^i^AINT Lo4dingvituif r^m AujiilliTv rtcrtorri" 

4999 REM LDb[3 LCirtiflg AT SDI^D brings VieyE ^tdh iLJXiLi^rr : 

fOOO ^OP! V[EV - 1 to 5 

SO^H ^ PDKE4>AI1Pt,V9Ey - 33 

^040 : CALL flmilGP4GE 

NCHT VlEy 

5f9r HEPi 

5QQ9 PEP* or uncIL the fuEVbLcPH^T 

4[>l>[> COT^ SDDD 



Stofing Data Strings from Pascal 

These Pascal j-ouTrnes use iDcations scOO To ibfpf ifi trie auxiliary 
memory for storage and letrfeval oi firings. 

The code That moves Ihe strings to and from auxifiafy memory ^s 
Stored at £000 in Ihe Extended BO-Column Text Card A separate 
Tnltiafization routine purs ttus code at £000, jusi once, lo mainlain 
system performance. 

The retrieval routine is very fast, roughly equivalent to a Hove L« ft 
from a Packed Array of Char, Tlie storage rouQne is less 
eHicfenl. if speed rs impoflanl ir^ your program, you may want to try 
to optimise It, 

Uhe Ihe other BwrnDlea, Ihass njuTinea were whiten for a particular 
applicdiiori 31*0 3te nut garer^- purpose siiOroutines. They are included 
here \o shpw you the kiiai ot Thing you can da with the dumHary 
rremory 



Extended Text Card Supplervienl 



AuAllliry M4marr String RDuimia 
IJV R- LtesTHf 



Thv foLLtiiPii^? rogt^nt hi p«rf or##d anlv ance. Thfl routines rJi4E «ave 

.TITLE ^ftSEPILr qoUTrhE^ III IH t T I A|. I Ei^T I DN 
.HOPl^TCKLlBT 



RDHllIH^ft .EQU 

RDAUIC^S .EQU 

yRRAlN^B .GQU 

mii^UiC^B -EBU 

RynAINlfi .EQU 

nuAuxia .Esu 

HIHESOFF ^eqU 

] 

«GTU«NO -EdU 

HETUINI ^EQU 

] qEsrarER HA^ 

J 

IHEUIM] rE4U 

EF^EIIOZ .E«U 



□ UT4 



iCiT 

ETA 
DET 

■ NE 

LDV 

■ HE 

5TA 
STA 

r EhD OF THIS RDUTIHf 



021 
Q£A 



; 5DFT SEE 
; Tit REFERENCE HANUAL 



E&DiETUF-l J Y 
0E0D1 r-r 

CiUT^n&D 

ElBiET"0F-1 hT 

□UT^HEl 
NIHE&DFF 



; UNITE AllR PfEnOflY 



; LEH&TJ* OF PATCH 

iCOC^E HGEE^Ihi; SAFE LOLATIPN 



- HWIJE I^AIH MEHDR1 

; HAi^E MINGS P- AVAI lAELE 



fDLLflvInf cade 1^ navfld to E HD? r 



Tht prognr* 9«t» h^r^ frnfe J^H in HDVE-FP^-AUX, 4nd goff b«ch 10 
thflt t[>tiu?iLivr^ ■friary c«n b« turned bicN of^. Jtri? pji^t ctfi cne 
• xitnded t^KC card ei^ntilAE ZHECCC 4nd EREi^DZh Ehtv Ai-e tne 

irguHvntK f«r tti4 HQ^ft. iTACk u9-Bg» : th# return «ddrv^s in ^Ah lA E n 
■ eHDr^ It EtcrtE^ in tha feuni Liary atACk. TM» 1i th* onLv UVQ the 

Au [ 1 L SMtf ei^nory 4t acl . 



PrQf)r«mming Exani{>lea 



ilk ^tkUX^B 
t USINC i^UX JEJID PAGE 

Til* 

RT5 



] READ AUX 4lPC 



7 HEAD HAIri ^PH 

J ^Oln^ tACt TO RAPI 



J 
I 

h 

r 
f 
I 



PurpotVt H^v4f ■ tTnn^ frON PASCAL JltkI LiarT ■ til Dry. 

If thft progriA fpndi th« Eninded S[?-CQLuan Te^t Card. th« 
To I L Qu 4 ng C4d# 4i ROvtd ct^ ElO£. 

The prDttraA gcti htrt fr^r^ a JSr^ 1n hciVE^TCf-AU^ ^ 4nd gptt bpch sir 
Lhjt tki JUEiLiary ntnAr r On turned batk off. 2«ro F^4g« an the 

+ Kr«nd«d t«Mt C4rd contvint ^ RE jnd ZREGCZ e^JECLr 4B t^^Y 4r« 

found en che HRhn itro o^ge. 

Etflcl. usAge] The return addre^t in ^tt rvim m^m^rf i « f t^rfd i n i he 

Hr>t4 aLto thjt ih« Bu-iMtry lern pege ta u9«d far th# tomd fra« 
idd refi^e^ . 

ZflEGOSi Address of mtege^ tnat uint^ knoi^ yhvre it wtt vtar^df 



nq rppn 



JRf^O^t Us4d tti md^E on r*c4ivlf^f> Address 



NGKTAVAI 
ElDSSTUF 



CLCi 

J l^FF^ H«AN^ RE^EreA^I: TQ BE{>I»ftIiig. DQNEFDfl EAC»HEH FILE 

Lot *o 

LDA e^RESDQ^^t 

fPiP ^dff 

INE E10ZC0 

NEKTAVAl+1 

UPA 

ITA NEVTAVAl 

«EQ E102FAIL 
Ci^HriHUE UITM AORHAL RC^UTINES 

L^X. NEXTAVAr-l-1 

tfti^ rCEF 

4IIE Eiq£Cl 



F 

E10^C4} 



; RESET 713 ICDD 



; UNCONDrTIQHJLL 



; CHECt FOt FJJJ.L 



Extended Text Cerd Supplement 



^PACt rs Pull, zu ftEiuftif zehq 









^0 




















tttA 






# 


trEruRN A lifrOn pull 




»rr 
















<r(1EG023 ,T 












EICiFAlL 




UHEdHDt nONAL 


; TMEHE IS 


STILL RDDH, ^13 CONTINUE 






E1DZM 


LDr 




'1 












(JnEtiCJ) ,T 


ri 


STDAE IN NETUHH AODR 




ftTl 






r 


SGTu^ THE HOVE 
















LDA 




HEJlTAvAl 








ITA 




{ZflEG4}£3 , Y 


L 

4 


LOU HVTE QF HETLIHI^ 










ri 


HOH€ Of THE PUVE 


r Npu iitiEHEar the 










HLj; 




















AOO 1 FEIN ETNINE LENCTH 




tME 
















MEKTAV.^1 hi 




NOLLEO INTO NEJ^T PAGE 




RLC 












LD^ 












At^C 






ri 


ADf^ LENGTH OF STHIHE; 




JTA 




N^KTAVAr 


J 
ri 


PUT IT lACK 




B-CC 




*+5 








iHi: 




NEKTAVAL+1 


4 


INTO ne:^t pai^e 




St J 




VtlAUX^fl 


; 


yRITINi INTO AUH ^flU 




LbA 




<ZHEGClCl3 , Y 


ri 


HEAOIbt AUJI 4ftfL 


4 










*T* 






ri 


yNITING ttAIN 4llK 




EM 




EID^EKIT 








lAi 










Eli]£LaaP 


LDA 




(Jf1EflDD3 ,t 








-STA 




CZIECa^^ pt 








DCt 












■ NE 




EIQ^iaOP 








STA 




ypin^iN^A 


J 




L 


ATS 








eOING EACH TQ «flK ItAH 




.END 










; 7ht fancying e«d» 14 


L h nkftd 1 hLA Lhri i 


rt 


pr^arAI. Thil CQdC 


; tt«r«& th# irgur^ent^ in th€ AUihLhAry ±£rn paqc And t^«n iu«p& to Efff 




L uAn T4 I E CAr4- 








-TITLf 


"JiSSEHILV nDUTIHES FOR 1 ]« 






.PAliE 












.NQMACnDLJ&T 










.NQPATCNLI&T 








HDMAIN^B 


.EQU 












-ECIU 












.EOU 
























.EQU 












.EQU 










RETUIH ADDICE££ Ji^hO I-OCATIOHE 






HETutNO 


.EOU 










flGTURNI 


.EQU 




QZA 







PfogrBmming Eiamplos 



4 
F 



^TITLE HO-rff STirill[;5 FIOH flC AUXfLI^tlT HEH04V" 



^ 0iJr&Of«; m^Wt ^ String frai BunI Llnrymv^ary tQ PfettAL^ HQIL oi tnfl 

J 

^ ScBCk uidgv: Input, output iddrtiftt^p 

1 

] STORE nEtUHH i^fiDh IN i^UK [(Rfl PAGE 

POP flETUNNQ ] 4ETU4II TQ PASCAL 

] AOOAE$£f$ ARE TUQ iYrES .PULL iDTN E^TES P THE ^AlH MAZ^, THEN SbllTCH 
I TQ AUK JGHO pAIjE Al»t> STORE MTW EtTES. 

tilt 

EM RVAUJIU ; SVlTC^t TO AL|K ZP 

irl ZHE&OS I Ih AUX ZENQ PAcE 

5TA ZHEIIOE^I | STILL IN AiJ>! NEH 

$Tik RuHAIkU ; SHITCN TO HAIli ;P 

; SrOPE At&RE&& IN AUII ZE4D PAGE 

PLA 
TAX 
PrLA 

STA pyAUIcU p E^ITCh TO AuH ZP 

fTJ! ZNEEOQ ; IN AUX ZERD RAGE 

jTA 2IEi;DD + 1 ;5TlLLlhALl^H&H 

] NOy AET OVER TO ^Ux PA(E AHCh DD IT ALL 
jfR QeQOZ 

: H^U PROCESS COhlNS MCt F*OH EDQF IH AUX HEh13Rr 

RTA NtfP^AlNli ; WAIN ZP AND TOP 

RUB4I lETURNd 

frTl ; (AtK TO PAICAL 



.T[TtE ~ttC>VE (TRINE^fr TO Ilfl AU^I Ll^B'f NEHOiT 

,PROC HDv^toAu.f 

PfeO^EtsuPE HOV«,Ta,AUK C VAR FffOHJLd VAN tOA? HoM4 tiring 



Purchflie: fiDMti PiiciL itnng to «vLiLi«i-vaeiDr>K. hn&t of thi 
Stick u&aat= Input. DUtpi^t 



STORE AETufiN AbDR IN AUX £ERO PACE 

POP RElURhD : *1AIN iP STACK 



Exi&ndfld Text Card Supplement 



S hDy STOfiC TO i^a&FtESS IN i^UX PACE 



PLA ; OF AOfrd DGTLPfrH 

-PUL 7 PISG APdd TO HGTL^fllj 

JTJL lUJiL^KI^ ; £UITC» TO AUH ZP 

l^M JRE«0; + 1 ; ITILL IN AUH H£H 

STA RUHAIHIA ^ tUITCH ID PAIN fP 

; Ffton ACtDHE^a IN AUJ| 2ENQ Pl^SE 

WLh ; lSH input ETHIHt 

rut 

ITA RVAUAlb ; aUir^H TD AUIT Z f 

frit fRE^OO ; IH AUA ZCflD PACE 

ETA fllE^OO^I r gJILL IH AUJ HEH 

; NOtf EET OVEfl ID AUK PAGE AND M IT ALL 

J3R OttD^ ; JUnP O^ER NEXTAVAI AT E1D? 

; flETU«N ^ROH |N LUH H«HOfl'f 

STA RUI1AIII16 ; MAIN TO NAIM JP ^NO TQP 

PLIffi RtrURHO 

hT» 



-END 



Prog ram ming Examples 



Index 



Index 



A 

accumulator 30, 31 
address bus 7 
address 30 
dale 79 

deslinailon slatting 30 

progran^ starling 31 

source starltng 30 

source endmg 30 

transfer 31 
fltfernale zero page 25 
ALTZP soft sw^lch 25 

figure 27 

fable 20 

warning 29 
Annunciator 3 11 

d>sp(ay page used 12 
Apple II 35. 36 

compatibilily 25 

system software 15 
Apple II Plus 35. 36 

GOmpallblliEy 25 
AppFe lie vim. 7, 35 

control keys 4 

display mefnory 18 

display modes 4 

display pages 1€ 

double ^igh^resDluHon 
graphics 11-12 

escape sequencer 4 

idenlllicalior} 'rorn assernbry 
language 37 

identiricallon from BAStC 40 

identification from Pascal 41 

Installrng tard in 3 

processor 4 

Rev A 12 

Rev B 11 
Apple lie ld&n|jflcailor> 

Program 30-39 
Apple lie IdenllfFcatlon Program 

(Pascal) 4142 

Indvx 



Appfesofl BASIC 17. 35 
program ei^ample using 

AUXHDve 44 
UEing 10 5lore graphics 
pa^es 43 
application progfams vlii, 21, 
35 

rur^ning wHti Ihe card vii 
assembly language 35r 37 
subroullnas 15. 37. 43 
programs lo use auxiliary 

memory 29 
routine for Pascal 41 

iU*. COhhtCTOR 3 

Se« alsci aui^iliary slol 
auJfiMary memory vlii. 4, 7, 9^ 

10. n. 13. 15. IB. 18, 19, 21, 

2?. 25, 29. 31. 30, 37 

accessjng 4 

address bus 9 

ad dress mg 7 

amouni 3 

careless sw^ichmg i 
how hi works 7 1? 
select swilches, t&ble 26 
subroulines 29-31 
switching 10 from bank- 
swhched memory 9 
transferring control lo 3D-31 
using vlll 

using from a program, 
e:^amples 35 5i 

warning 9. 15 
Au>Llifarv Memory Siring 

Routines 47-51 
auxiliary RAM 15 
aLij<ili3ry s^ol 11 

AUK . CONNECTOFt 3 

AUhHDVE aubroutme 15. 29, 30 
example using {Applesoft) 44 
parameters 30 
warning 29 



S3 



B 



D 



bandwidlh, video mornlor 11 
bank switches 9 
banh^awilched memory 9, 25» 
36 

warning 9 

whh auxtliary inemory 9 
BASIC 15, 37, dO. A3 

Apple^otl t7 

Inreger 17 

reading 30fl BWilches 
from 1 7 

warning using 15 
bil 29 
bit 7 17 
bit 

carry 29, 31 

G0lor-3alecl 19 

hlgJi'Order 19, 22, 35 

overflow 31 

Sign 17, 22, 25 
bulii'ln SO-colurnn diaplay 

routines 16 
buill In I/O roullnes 21 
bulii'in subfoulrnes 29. 30 
bus 

addEQ&a 7 

data 7 
byte 

high-order 30, 3i 
low-order 30, 31 

c 

TALL Statement 15, 40 
carry bil 29, 30, 31 
circuitry, display ^Q 
C Lt Insirucilnn 29f 30 
clock cycle 9 

wlih BO-cotumn display 
cr\ 10 
CLV Inslfucllcn 3l 
coIdj" monilcr, RGB 10, 11 
CDlor^seleci bil 19 
commands 

PEEK 17, 43 

POKf 17, 43 
computer cortflguralion, 

Idenlitymg 35-37 
conllguralion 35 
GonhguraTlort of fhe 

compuler 35 37 
control keys 4 
control switches 22 



data addresses 39 
data bus 7. 1i 
data, moving 29 
DATA stalemenls 40, A3 
data si rings AG 
decimal 17 
destination starting 

address 30 
display bulfer A3 
display circuitry IS 
display cycle 9 
display data 10. 21 
display modes 4 
display pages 16 

control SAilches 22 

length 9 

locaiions, lable 16 

See also graphics pages 
display soft switches. Table 13 
display, SO-coFumn 19 

figure 20 
DOS 3 3 vlii. 15. 21 
dot patterns 10 
double high-resolulion graphics 

[560 dolf 11 12, 19 

Dhlaming 11 

board necessary for 12 

with Rev A Apple Me 12 

c 

aO-CDiumn card, any 36 
eO column display 10, 11, 1G, 
19, 36 

addressing directly 13 

bandwidth needed 10 

firmware 3, 4, 36 

ngure 20 

map 10 

slccing daia 9 

switch tor 11 

with clock cycles 9 

versus flO-coiumn display Idol 
pat tern si 10 
eOCOL 3olt switch \8 
BO Column Texl Card 4. 16, 35, 

36 

SO column text 11, 12, 19 

mode 12 
BOSTOHE 50lt switch 13, 19, 22 

figure 23. 24, 28 

■able 26 

warning 21 



Exiended Text Cerd Supplement 



escape sequences A 
expansion slot 3 3S 
fcxlenafid flO-Column Texl 

Card ir 35- 46 

buffer 10 

coRnectlna pins n 

c1^^1e^e^ce5 from SO-Column 
TeKl Card vtii 

sloring dala diraclly 19 

F 

firmware. SO coiumn display 3. 
4, 36 

SeOdol graphics 11, 12, 16 
See also graphics 

flO'Column lejiL 11 
mode IB 

AQK bank, swJlctiinfl 31-22 
46 K mflmory space 9, 21 
14MHz 10. 11 
tunclions 

keyboard 17. 35 

Pascal 15 

G 

Globe 45^46 

graphics mode, double high- 

resolulion 12. 19 
graphics Page IX (high- 

resolution) 19 
graphics pages 43 

Sloring Irom Applesoft A3 

See also display pages 
graphics 

2eo-doi IS 

560-dol 12. 16 
double-high-resoljElon 19 
do u h I e-h ig h-re sol ul ion 

memory mappplng 19 
high-resDluiion. Page i 19. 

22 

high-resolullon. Page IX 19 
high-resolullon program 
Skample 45-46 

H 

heifadectmal 16, 17 
high-level languages 15 
high-order bll 17, 19. 22, 25 
hhflh-order byle 30, 31 
high resolution graphics li, 
36, 43 

Page i 12, 19, 22 
Paga 1X 19 



pages 43 

program ax ample 45-46 

switch for 1 1 
HIRES sofi switch 16. 19, 22 

figure 24. 28 

table 26 

warning 21 
horizonUl rasolulion II 



I dent meat ion return codes, 

fable 35 
IdentilicatLon routine 35, 4rj 

oulllne 3637 

warning 37 
Identilicatfon, Apple lie 

{assembly fanguagej 37 

idenrirication, Apple lie Irom 

BASIC 40 
Insialiatlon 3 
Instruction 

CLC 29. 30 

CLV 31 

J5R 37 

Jump 31 
SEC 29. 30 
Inleger BASIC 17 
Interpreler. warnmg using 15 
interrupts 36, 37 
\I0 7 

links, standard 21 

routines, built-in 21 

subroutrnes 29 

J 

J S H instruction 37 

lump Inslruclion 31 

jump lo subroutine (JSI^ 37 

K 

keyboard funcllons 17, 25 
L 

iow bandwidth monllor 19 
loworder byte 3D, 31 
low-resoluflon graphics 1i, 16 

M 

machine language 17 

programs 17 
main logic board 

buffer 10 

Rev A 12 

Rev B 11 



Index 



main memofy vlH^ 7, 9, AG, 12^ 

15. 16. IB, 19. 21. 35. 3T 

address bus 9 

^WLtchrng 4 
memory 

amount card coniaina vilt 

aLixillary 15 
select swIlcheB, laQle 26 

bank-swFrched 25 

reading ?1, 25 

wnling 21. 22. 25 
memory locaiions 17 
Memory Management Unll 7 
memory map 9. 12^ 19 

diagram 8 
memory p&ge^. lenglh 9 
memory swilchmg 15 
mixed grapliics modes l"! 
M11£D SOfl switch la 

MMU 7 

mpde&r mised graphics n 
MoleX'lype pins 1 1 
Monitor program 19 
monUor, low b^ndwjdEh 19 
monochrome monlior 11 
moving dat^ 2Q 

N 

negative decimal 17 

o 

operaElon 
read 17. 25 

warning with 17 
write 17, 25 
warning wilh 17 
Qverriow bit 31 

P 

Page 1 
dksptay 19 
graphics 22 

hFgh-resolLition graphics 12^ 
19 

lexT 18. 18, 22 
page one 9 

warning 29 
Page ix 

dispiay 16, IB. 19 

hlgh^fesQlutlon graphtcs 19 

le^^f 16 
pageSn high-resoluElon 

Qfaph^cs 4-3 
Page 2, lejti 16 



PAGEZ soft awilCh IB, 19. 22 

figure 28 

table 26 

warning 21 
page zero 9, 29^ 3Q. 31 

warning 29 
pa ramblers 30 
Pascal 30. 35. 37, 41 

l■^ viiL 15 

fLtncllons 15 

procedures 15, 30 

routines, programming 
examples ^7-5T 

storing data strings from 46 

warning using J5 
PEEK 17. flO, 43 
POKE 43. 17 

power-on light 3 
procedures, Pascal 15. 30 
procedures, assembly^ 

language 29 
processor 4 

processor status word 29. 31 
program starlmg address 31 
program 

Apple He IdentiNcatiOn 36 39 

Appfe Me idenlificalion 
(Pascal* 41-42 

Appieaofi example using 
AURHOVE 44 

assembly ^ language 29 

macfi me- language 17 

Monitor 19 
prog ram ma bie memory. 

amount 4 
programming examples 35-51 

R 

RAM 4. 7 
amount 3 

flUJiiliary memory 15 

RAHRD son switch 21, 22 

figure 23. 24 

table 26 
RAHtfPT sort switch 21, 22 

figure 23, 24 

table 2B 
read operation 17, 2S 

warning 1? 
reading memory 21. 25 
regislerSn X and V 30 
Rev A Apple He 12 
Rev A main iDglt board, 

warning 12 
Rev e main logic board 11 
RGB coJor monilor lOp 11 



Ekisnded Text Card Supplement 



ROM 7, 21 

routine, idenllhcation 25, 

outline 36-37 
roullnes, bulINn 30 

s 

EEC inStruCTlon 39. 30 
7MHz 10 
5\gf) blE 17, 22, 25 
6503 microprocessor 7 
6S03 Slack 9 
warning 29 
5lo[ 3 35 

aolt swilchBs 7, 11, 15, 16, 17, 
29, 31, 37 

accommodalmg 25 
ALTJP 25 

figure 27 

table 25 

warning 29 
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